---
title: Refresh Control | gluestack-ui

description: Component to add pull to refresh functionality. This component is used inside a ScrollView or ListView. When the ScrollView is at scrollY 0, swiping down triggers an onRefresh event. It is embedded react-native `Refresh Control` with all utility props of `gluestack-ui/themed`.
---

import { Meta } from '@storybook/addon-docs';
import { useRef, useEffect, useState } from 'react';

<Meta title="ui/Components/React Native Components/Refresh Control" />

# Refresh Control

Following is the default implementation of the **Refresh Control** component without any additional customization. This serves as a starting point for users who are new to this library and want to learn about the basic functionality and appearance of the component.

> Note: Refresh Control component is an iOS/Android only component, please try the example on the respective devices.

<iframe
  src="https://snack.expo.dev/embedded/@gluestack/refreshcontrol-example-gluestack-ui?iframeId=wyhh69uyix&preview=true&platform=ios&theme=dark"
  style={{ width: '100%', height: '60vh', border: '0px' }}
/>

<br />

> Note: You can refer [here](https://github.com/gluestack/gluestack-ui/tree/main/packages/themed/src/components/RefreshControl/styled-components) to learn about default styling of Refresh Control component

### Import

To use this component in your project, include the following import statement in your file.

```bash
import { RefreshControl } from '@gluestack-ui/themed';
```

### Anatomy

The structure provided below can help you identify and understand a Refresh Control component's various parts.

```jsx
export default () => <RefreshControl />;
```

### API Reference

The following section contains a comprehensive list of the component's references, including descriptions, properties, types, and default behavior. This information is readily available for you to access, helping you effectively utilize the component library in your projects.

### Refresh Control

It inherits all the properties of React Native's [Refresh Control](https://reactnative.dev/docs/refreshcontrol) component.
